Die Request<T> Klasse hat eine Eigenschaft "Ticket". Über diese wird die Authentifizierung an dem Web-Service übergeben.
Um ein neues Ticket zu erhalten, muss die Login Methode aufgerufen werden. An diese wird der Benutzername und das Passwort übergeben. Wenn die Anmeldung an c-entron erfolgreich war, erhält man ein Ticket zurück (eine zufallsgenerierte Zeichenfoleg). Über diese Zeichenfolge weiß der c-entron Web-Service um welchen Benutzer es sich handelt.
https://server.de/CentronService/REST/Login{ "Ticket": "", "TrimResponse": 0, "Data": { "AppVersion": "1.0.0.0", "Application": "{8A9E6F82-4DFF-4C93-916C-CEA90EE4ED22}", "Device": "OfficeClient1", "LoginKind": 0, "Password": "Pa$$word!", "Username": "CentronUser" }}
Methoden für die Anmeldung / Verwaltung von Zugängen
| Methode | Beschreibung |
|---|---|
| Login | Dies ist die wichtigste Methode im Web-Service. Über diese meldet sich der Benutzer an dem Web-Service an. |
| Wenn die Anmeldung klappt, erhalten Sie ein Ticket zurück, welches Sie fortan bei allen Methoden beim Request Objekt angeben. | |
| Request: | |
| Username : c-entron Anmeldename | |
| Passwort: Passwort von dem Benutzer | |
| LoginKind : Gibt an um welche Anmeldeart es sich handelt.0 = c-entron Benutzer1 = Gezwungene Anmeldung übers AD. (in der Regel nicht notwendig. Wenn AD-Anmeldung in den Einstellungen aktiviert wurde, werden alle Anmeldungen mit der ID 0 automatisch auf 1 auf der Web-Service Seite gestellt.2 = Kundenzugang (Web-Account) | |
| Application : Hier die folgende Guid angeben: | |
{8A9E6F82-4DFF-4C93-916C-CEA90EE4ED22} | |
| AddVersion : Hier können Sie die Version Ihrer Applikation übergeben (optional) | |
| Device : Hier können Sie das Gerät über welches sich angemeldet wird übergeben (optional) | |
| Logout | Über diese Methode können Sie einen Benutzer (über das Ticket) vom Web-Service abmelden. |
| IsValidTicket | Diese Methode prüft ob das Ticket noch gültig ist. |
| CheckConnection | Diese Methode liefert einfach den Wert True zurück. Über diese kann geprüft werden ob eine Verbindung zum Web-Service aufgebaut werden kann. |
| Diese Methode erfordert kein Ticket. | |
| IsWebAccountAuthentification | Mit dieser Methode können Sie prüfen ob es sich bei dem Ticket um ein „Web-Account“ handelt (Kundenzugang). |
| GetAllConnectionTickets | Über diese Methode können Sie alle angemeldeten Benutzer auslesen. |
| RemoveConnectionTicket | Über diese Methode können Sie Benutzer vom Web-Service abmelden. |
| GetWebServiceSettings | Diese Methode liefert besondere Web-Service bezogene Einstellungen zurück. |
| SetWebServiceSettings | Diese Methode speichert die besonderen Web-Service bezogenen Einstellungen. |
| GetCommonLoginInformations | Diese Methode liefert Ihnen allgemeine Informationen zu dem angemeldeten Benutzer zurück. Unter anderem welche Rechte dieser im System hat. |
| IsUserAdmin | Gibt an ob der angemeldete Benutzer ein Administrator ist. |